home *** CD-ROM | disk | FTP | other *** search
/ Aminet 45 / Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso / Aminet / disk / misc / UnADF.readme < prev   
Text File  |  2001-09-05  |  6KB  |  170 lines
  1. Short:    V1.2, Extract files out of DOS ADF files.
  2. Author:   Andrew Bell <andrew.ab2000@bigfoot.com>
  3. Uploader: Andrew Bell <andrew.ab2000@bigfoot.com>
  4. Version:  1.2
  5. Type:     disk/misc
  6. Requires: 020+, OS 3.0+, 2MB of fast memory recommended.
  7.  
  8. (See "History" for info on the changes made since the last public release)
  9.  
  10. Introduction
  11. ------------
  12.  
  13. UnADF is a Shell tool that allows you to extract the files out of an
  14. AmigaDOS OFS/FFS formatted ADF disk image file. With the various versions
  15. of UAE available, ADF files have become very common. An ADF file is simply
  16. the entire data of an Amiga floppy disk saved as a file. UnADF allows you
  17. to save the entire contents (i.e files & dirs) of these ADF files to your
  18. harddrive.
  19.  
  20. AmigaDOS ADF files are very similar to archives, they contain files just
  21. like archives do, but weren't actually intended for this purpose.
  22.  
  23. UnADF allows you to quickly obtain files from within ADFs, without having
  24. to resort to device drivers such as fmsdisk.device.
  25.  
  26. Features
  27. --------
  28.  
  29. UnADF supports OFS, OFS-Intl, OFS-DirCache, FFS, FFS-Intl and FFS-DirCache
  30. ADF floppy formats. It also supports hard links to files and directories,
  31. that are normally created with the AmigaDOS "makelink" command. Both
  32. Double Density (901120 bytes) and High Density (1802240 bytes) image sizes
  33. are supported.
  34.  
  35. With the help of xfdmaster.library, UnADF can decompress compressed ADF
  36. files before extracting. xfdmaster.library is not included with UnADF, but
  37. can be obtained from Aminet. UnADF does not require xfdmaster.library and
  38. will work without it.
  39.  
  40. Notes
  41. -----
  42.  
  43. Softlinks are currently not supported in this version of UnADF, and all
  44. checksums are ignored, so always check that your data is valid after you
  45. extract it.
  46.  
  47. UnADF might slow down a little if it encounters an ADF with heavily
  48. fragmented hash chains or data blocks.
  49.  
  50. But floppies are obsolete!
  51. --------------------------
  52.  
  53. Just because the medium itself is becoming obsolete, it doesn't mean that the
  54. data on those disks is obsolete too. For example, I bought 9 or 10 commercial
  55. Amiga titles fairly recently, and half of these came on floppy disks! I use
  56. FloppyFlux to store backups of these disks on my harddrive as ADFs. If I
  57. need to get files from them, I use UnADF. I try to avoid them little plastic
  58. floppy disks as much as possible, I'm only interested in the data they
  59. hold. ;)
  60.  
  61. You can get the latest version (currently 1.2) of FloppyFlux on Aminet at:
  62. disk/bakup/FloppyFlux.lha.
  63.  
  64. Non-DOS ADF files
  65. -----------------
  66.  
  67. Not all ADFs are formatted with FFS/OFS, but instead use their own custom
  68. disk format. This includes most games and demos, so UnADF will report these
  69. types of ADF files as non-DOS/corrupt or will report the rootblock as
  70. invalid.
  71.  
  72. Requirements
  73. ------------
  74.  
  75. 020+, OS 3.0+, 2MB of fast memory recommended.
  76.  
  77. UnADF is *VERY* memory hungry, especially while decompressing ADFs.
  78.  
  79. Usage
  80. -----
  81.  
  82. UnADF is very easy to use. There are currently three parameters:
  83.  
  84. LOWMEM - Tell UnADF not to load the entire ADF file to memory. This option
  85.          slows down UnADF a *LOT*! If this option is used, UnADF can't
  86.          decompress ADFs, because the entire ADF must be loaded into
  87.          memory for decompression.
  88.  
  89. LIST   - Switch, this tells UnADF to list the contents of the ADF only.
  90.  
  91. DEST   - The destination directory. A little note: UnADF doesn't actually
  92.          save the contents directly to this directory, but instead creates
  93.          a sub-directory inside it, with the name of the disk.
  94.  
  95.          So for example, if an ADF was formatted with the name "Empty", UnADF
  96.          will use this name as the name of the sub-directory. If a sub-
  97.          directory already exists with this name, then UnADF will append an
  98.          extension in the form of <dirname>.<number>, e.g. Empty.001.
  99.  
  100. Examples: UnADF Store:MyADF.adf DEST=ram:     ; save dir to ram:
  101.           UnADF dh1:ADisk LIST                ; view contents of an ADF
  102.  
  103. History
  104. -------
  105.  
  106.  1.1 (28.12.99) - Initial release.
  107.  
  108.  1.2 (11.02.00) - UnADF now copies file comments, date stamps and protection
  109.                   flags. Added at the request of Jan R. Haugan.
  110.  
  111.                 - Redesigned the extraction routines. They are now a little
  112.                   slower, but very memory efficient.
  113.  
  114.                 - Added the LOWMEM parameter. This tells UnADF not to load
  115.                   the entire 900K+ ADF to memory. Only small amounts will
  116.                   be loaded into memory at any one time.
  117.  
  118.                 - Improved error checking while saving files.
  119.  
  120.                 - Added support for High Density ADF images. HD support
  121.                   never made it into version 1.1 because I didn't have a
  122.                   HD floppy drive to rip one for testing. Special thanks
  123.                   go to Dirk Stoecker for giving me some tips on how to
  124.                   create one without needing a HD floppy drive. :-)
  125.  
  126.  
  127. Copyright
  128. ---------
  129.  
  130. UnADF is Copyright © 1999 Andrew Bell. All rights reserved.
  131.  
  132. UnADF is FREEWARE, this means you can copy it as many times as you like
  133. as long as no profit is gained from it's distribution and all of the files
  134. remain together in their original and unmodified state. You are not allowed
  135. to distribute modifed versions of UnADF or it's related files.
  136.  
  137. With the rise of WinUAE, a lot of illegal ADF files have appeared on the
  138. Internet that contain copyrighted material, mainly games. I received a
  139. lot of emails assuming that FloppyFlux had been designed for storing such
  140. ADFs, let me put the record straight, I DID NOT! Both FloppyFlux and
  141. UnADF were designed for storing and handling personal disk collections
  142. such as PD or magazine floppy disks, and not illegal ADFs from pirate web
  143. sites.
  144.  
  145. The author does not condone the use of illegal ADFs with UnADF or FloppyFlux.
  146.  
  147. Author
  148. ------
  149.  
  150. My name is Andrew Bell and you can contact me via email at:
  151.  
  152. -- andrew.ab2000@bigfoot.com
  153.  
  154. Or to get the latest version of this program and to see my other work you
  155. can visit my web page at:
  156.  
  157. -- http://www.andrewb.exl.co.uk
  158.  
  159. Enjoy! :-)
  160.  
  161.  
  162. ============================= Archive contents =============================
  163.  
  164. Original  Packed Ratio    Date     Time    Name
  165. -------- ------- ----- --------- --------  -------------
  166.    19532   10310 47.2% 11-Feb-00 00:19:28 +UnADF
  167.     6011    2694 55.1% 11-Feb-00 00:19:28 +UnADF.readme
  168. -------- ------- ----- --------- --------
  169.    25543   13004 49.0% 16-Feb-100 22:09:58   2 files
  170.